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Rude Noligs 
Editorial 





Weill, a new year begins for 
~S.T.ULN. .... 


Nell seems to be going great 
guns, and after a close shave, we 
seem to. have a pretly solld lineup 
of offloers. |, meanwhile, move 
from President to Newsletter 
Editor. Nell certainly is a motivator, 
since | had every intention of 


programming ventures this year. 
Nell and Howard, however, are my 
two senior partners in orime. “All 
for one and one for-all” to steal a 
phrase. 


The newsletter returns to monthly 
printing with this issue, and will 
remain so for the nend year. This 
means that any support we can 
get from the membership will be 
greatly appreciated. Send in the 
articiee!! Reviews, tutorials, 


| hacking hints, anything. Send ‘em 


The newsletter will also be printed 
on disk beginning with the 
October ‘89 Issue. Too many 
reasons to go into here, but If you 
really want to know them all, give 
me a call. 487-8648, evenings. 
Glad to talk to you. Also notice 
that the entire year’s deadiines for 
ads and submissions appears in 
the masthead. Will every month, 
too. Set In concrete, so you can 
pian the year ahead if you are 
writing or advertising with us. 


One final thing...Check out the ad 
for DreamPark...Nifty, huh? Look 
for a totally new game concept 
from those guys... R 


Programming Spreadsheets 
Howard Abrams 





Part ll - Keyboard Equivalent 
Menus 


Last ime, we talked about using 
macros to move the cursor 
around the spreadsheet, to make 
“bulk-entry” or data easier. in this 
article, we'll diecues using macros 
to simulate heavily used menu 
commands. 


INPUT DURING MACRO 
EXECUTION 


Going back to our Checkbook 
Example from Part | of thie series, 
we could have the program 
automatically move us from 
column to column. 


in cell AA1, we would begin by 
typing In | 

{RIGHT} {RIGHT} {RIGHT}. And for 
ease of use, lets put 
{DOWN} {LEFT} {LEFT} {LEFT} tn 
cell AA2. This will get us where we 
want to go, but we need to have 
the macro stop and allow us to 
enter figures into the epreadsheet. 
For this, we put the {7} code 
before each of the {RIGHT}s. Cell 
AA‘ now looks like: 


a {RIGHT 
a~ 


We begin by placing the cursor 
under Cheok Number, and 
pressing [ALT]}-[Z]. The program 
will pause and walt for us to type 
In a value for check number. 


When we press [RETURN], the 
program moves our cursor one to 
the right and waite for us to put in 
the date, and continues until after 
amount, which moves us to the 
beginning of the nend line. 


We need the tilde (“~’”’) at the end 
of the line so that when we are 
finished typing, the program 
accepts the input and places It In 
the cell that Ie highlighted. 
Otherwise, when the macro 
finished, we would have to press 
[RETURN] again. (Actually, this is 
optional in the current example, 
because on the next line of the 
maoro, the first command is 
{DOWN} which make the program 
accept the Input) 


MENUS IN MACROS 


When we placed keyboard 
characters like the arrow keye In a 
menu, we put a name represen- 
tation of it in the cell (le. {LEFT} 
for the Left Arrow). if we want any 
other keystrokes, we can just type 
them in. 


For instanoe, lete suppose that we 
need to change celle to peroen- 
tage format with one decimal 
place. We could write a macro to 
formad any cell that we are 
pointing to. 


First, lets move to cell AAl and 
type, “/ipi™~” (without the 
quotes, of course). The slash key 
will get us to the menus, then “r’ 
for Range, “f” for Format, “p” for 


continued on page 9... 








ST Drive Switch 
Bill Pike, Portiand Atari Club 





lf you have a 620ST or 10408T 
with a internal drive that drive Is 
always DRIVE A and the external 
drive is DRIVE B. This Is fine until 
you want to boot a disk from the 
external drive or the internal drive 
needs to go the the dootor. You 
are then up the proverbial estuary 
without the necessary means of 
propulsion. Anyhow | have added 
a switch to my 6208T that will 
switch the drives making the 
external drive DRIVE A and the 
. Internal drive DRIVE B. This allows 
you to select which drive will be 
your boot drive and allows you to 
operate without a internal drive if 
necessary. it will also allow you to 
ewitch drives, in mid-stream Hf you 
have the disk in the wrong drive. 
You will have to wait until the drive 
activity light goes out, meaning 
that the computer is no-longer 
accessing a drive or you could 
bomb/uill the disk. 


DO NOT ATTEMPT THIS 
MODIFICATION UNLESS YOU 
HAVE DONE WORK ON 
COMPUTER BOARDS BEFORE 
OR HAVE PREVIOUS 
EXPERIENCE WORKING ON 
PRINTED CIRCUIT BOARDS AND 
IC CHIPS. 


HERE IS THE NECESSARY 
DISCLAIMER: NEITHER THE 
AUTHOR OR THE PORTLAND 
ATARI CLUB TAKES ANY 





RESPONSIBILITY FOR THE 
RESULTS OF THIS MODIFICA- 
TION INCLUDING BOTH 
SOFTWARE AND/OR HARDWARE 
DAMAGE IF THIS MODIFICATION 
IS PERFORMED. THIS MODIFICA- 
TION WILL ALSO VO!ID ANY 
WARRANTY ON YOUR COM- 
PUTER. 


This modification has worked on 
quite a few computers that it has 
been used on and the only 
problem seems to be that some 
computers might try to write to the 
disk on boot up but | have had no 
probiem in this area. Anyhow you 
might want to write protect your 
boot disks, this is a good idea 
anyway. 


Now to the actual modification. 
You will need a Phillips Serewdri- 
ver, a email slot head screwdriver, 
& set needie-nose pliers, a set of 
wire strippers, a set of diagonal 
outters,a small soldering iron, 
de-soldering wick or a solder- 
sucker, and a 1/4” drill. That 
concludes the listing of the tools. 


Parts required are, a suib- 
miniature Double Pole/Double 
Throw switch, and about 3 fi. to 
number 26 or emailer hookup 
wire. First the computer selects 
which drive Is going to be used by 
the YAMAHA (YM2148F)chip 
labeled U-19. This le the VO 
interface chip. The chip sets in the 
back-oenter of the board and le 
next to the RF Modulator which is 


continued on page 9... 


Firmpak ST 
meview 
Nell Breeden Il 





FIRMPAK ST a a email bag 
containing 95 springs that are 
placed under the keys on the ST 
keyboard to stiffen up the keys. 


| have just installed the springs 
and have loaded 1st Word. 
already | think the keyboard feele 
better. Athough It now sounds 
slightly different from before it hae 
a better feel. | am told that It Is 
more like the keyboard feel of a 
Mega, having never typed on a 
Mega | cannot vertfy thie. 


As stated above the Kit consiste of 
95 springs and 1 page of 
Instructions. The doce suggest that 
the Function keys, the return key 


Key Cap Remover 


Small Hooks 
Final form of key remover 





and the shift keys not have the 
springs added under them 
although enough springs are 
supplied to add them to these 
keys if you wish. The instructions 
also show one method of 
removing the keyoaps from the 
keyboard. | prefer using a stiff 
piece of wire. it needs to be about 
4 inche long. A large paper clip 
worke well. | bend a small hook on 
each end of the wire then fold It 
around my finger. The smail 
hooke are sild up under two 
oposite comers of the keyboard 
and the Wire pulled up upon. The 


keycap will then pop off. 


Finished layout of the keycap 
remover: 


[See Figure below] 


continued on Page 9... 





Hisoft "C’ interpreter 
Review 
Howard E. Abrams 





Do you remember in the “good 
old days” when you were trying to 
learn to program in C? “C 
certainly stands for cryptic” you — 
sald as you would type in 
examples from your book, Then 
came to moment of truth- compile. 
I'm sure people three blocks away 
heard you soream as the errore 
flowed right off the top of the 
soreen. | remember going back to 
Basic many times because of my 
frustration with C. 


Those days are over. MichTron Is 
now shipping a C interpreter from 
HiSoft. Now you can “run” the 
program immediately like you 

— could with Basic, and compile it 
later. it has all the abliiities that you 
enjoy with your favorite Basic 
interpreter, like tracing and 
variable display, easy to use GEM 
calls, and a nice GEM-baee editor. 
it even has a memory and stack 
dump that allows you to view © 
variables in memory. 


C IMPLEMENTATION 


The version of C that comes with 
this Interpreter uses a K&R version 
with some UNIX and ANSI function 
calls. it also includes ail the 
standard AES, VDI, GEMDOS, 
XBIOS function calls. | noticed that 
it didn’t have the abiilty to declare 





Immediate constant arrays. For 
example: int foo[] = { 1, 46, 32, 6, 
12, 69, 5, 0, 49, 2, 8}; Ie not 
allowed. | also couldn't define 
aggregates. Structs also posed 
some probleme in that variables 
defined in one struct couldn't have 
the same name ae another 
variable in another struct. For 
example, these two structe 


couldn't exist in the same program 
because both x and y are used as 
variable names in the same 
structure: 

struct foo struct fop 

{ { 

int x; int Ww; 

int y; int x 

Int w; int y; 

int h; int z 

} h 

To speed up execution of the 


code, the source code Ie 
tokenized in memory. Converting 
regular ASCil fliee over ie quite 
easy and Ie done in the editor 
Neelf, It aleo includes limited help 
files for reference. 


You oan break your program up 
into modules and use header files. 
Since the header files are 
tokenized, you must convert your 
pereonal ones over. Most 


continued on page 12... 
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Programming Spreadsheete 
continued from page 5... 


Percent, 1” for the decimal piace. 


at thie point the program will ask 
us for the range of cells. Since we 
just want the particular cell that we 
have highlighted, we would just 
press [RETURN], and so we put 
two a 


Now name It using the Range- 
Name-Create "/me” command 
and oail it, \P. Now by pressing 
[ALT]-[P], the program will 
ohange the format of the cell that 
we are pointing to. 


INPUT DURING FUNCTIONS 


Lets suppose that we would like 
an easier way of putting in the 
date in our macro. Sure we could 
type @DATE(89,8,1) for the 
date,but after a while, we will 
begin to look for short-cuts. 


Change cell AA1 to read as the 
following: 


{7} {RIGHT} @DATE({7},{7},{7}) {Rl 
GHT}{?}{RIGHT}{?7}~ 

Notice that in place of the year, 
month, and day for the @DATE 
function, we place {7}. Upon 
reaching the date column, the 
program will print on the top line: 
@DATE( for us. We type in the 
year and press [RETURN]. The 
program places a comma, and 
waite for the month. Now ien’t that 
a little nicer. 


AUTO STARTING MACROS 





For the sake of completeness, I’m 
going to introduce the Auto 
Starting macro. It’s purpose 
probably won't become to useful 
until after the next article. 


if you name a macro “\0”, twill | 
automatically go once you've 
loaded up a sheet with that macro 
on it. Perhape if we had a maoro 
that could “find” the next available 
location for a cheok, then we 
wouldn’t have to. 


Next time we'll explore some 
codes that one cannot access by 
any other way than with a macro. 


R 
FirmPak ST 


continued from page 7... 


After all the keycaps are removed 
it is a good idea to remove ail the 
dust, halr eto that has collected In 
the keyboard. | use a vaccum with 
& soft brush atiachment to vaccum 
the dirt from the keyboard. Piace 
the spring over the key-post, line 
up the correct key over the 
key-post and press it down fill It 
snaps back Into place. The only 
problem | found was in the 
instructions. The say “Install a 
Key-STIFFENER around each 
key-post, Narrow end down.” The 
harrow end of the springs would 
not fit over my key-posts. | finally 
placed the narrow end up and 
replaced the keys. So far | haven't 
had a probiem with this configu- 
ration. 


The instructions also state the 








following warming: 


Although the installation of this 
product le fairly simple, we 
strongly recommend that it is done 
by someone experienced with 
ATARI hardware. 


| had no problem and feel anyone 
with the desire and an hour to 
spare should have no problem 
doing the conversion. NOTE: if 
you decide to do this upgrade | 
will not be responsible for your 
errors. 


Weill to sum It all up | am very 
pleased with the FIRMPAK ST 
upgrade. | program for a living 

- and my keyboard of choice Is a 
VT200 series keyboard. Thie 
upgrade makes the keyboard feel 
a litte more like a VT200 series 
keyboard. | like a stiffer keyboard 
and the springs really help to 
stiffen it up. 


ST Drive Switch 
continued from page 6... 


a siiver-rectangular box located 


just to the right of the center of the 
back section of the board. Clear a 
fairly large area on a table and 
have good light, you will have 
things spread out over a fairly 
large area. #1 disconnect all 
cables hooked to the computer 
and turn the computer over on its 
face with the bottom facing you 
and the keys next to you. You will 
see several screws (Phillips head) 
on the bottom. Remove these 





sorews, three of them will be muoh 
longer than the others. Aleo keep 
separate, by length, screws that 
are the same and remember 
where they came from. #2, slip 
your hand under the computer 
and hold the top and the keyboard 
In place. Then turn over the 
computer so that It is right-side 
up. #3, carefully lift the top off the 
computer and set It aside. You will 
note that the keyboard Ie left on 
the computer. #4, carefully lift the 
keyboard and note that it le 
attached to the computer by 
several Wires and a plug on the 
right hand side. Carefully remove 
the plug from the computer board 
and set the keyboard aside. #6, 
you now to remove the internal 
drive. There le a metal shield over 
the cables connecting the drive to 
the computer on the left side of 
the drive unit. There are one or 
two screws holding thie email 
shield, remove these screws and 
remove the shield and set It aside. 


You will see a flat ribbon cable, 


with a plug on it, and several 
colored wires that go fo a plug on 
the back of the drive. Carefully lift 
the right hand side of the drive, the 
side with the disk slot, slightly and 
then lift the drive and move it 
slightly fo the right. You can then — 
remove the flat ribbon cable by 
gently pulling on the plug 
connected to the drive. The other 
plug hae a retainer as part of the 
jaok that It goes into, this ie a small 
pin on the jack that engages a 
email slot in the plug, lift this with a 
email siot head screwdriver and | 


pull the plug gently loose. #6, you 
now need to remove the Power 
Supply. There may be a email 
shield covering the wires 
connecting the Power Supply to 
the main board, remove the 
screws holding thie shield and set 
Kt and it’s screws aside. You may 
or may not have this shield on 
your computer. There ie a small 
plug connecting the Power Supply 
to the main board, remove this 
plug. You may now lift the power 
supply olear and set It aside. 
Older models may not have a 
internal power eupply. #7, you will 
now see the RF Shield this is heid 
In place by a series of twist olips 
along the edges. Twist each of 
these clips to line up with the siot 
that it is in then gentty lift the 
shield. DON’T FORCE IT. Onoe 
you have the shield off set It aside. 
You are now able to remove the 
bottom shield by tuming the main 
board over and removing the 
shield, do so. Turn the board back 
upright. #8, now locate U-19, this 
ie the fabled YAMAHA onip, this Is 
a 40 pin chip with the label 
YM2149F on It. Inepeot the chip, 
on one end you Will see a dot on 
one corner, this Indloates that the 
pin, leg, in that comer ie number 
1. Count down the pins, starting 
with that pin until you find pine 19 
& 20, these should be the last pins 
on that side of the chip. VERIFY 
THAT THESE ARE PINS 19 & 20 
UNTIL YOU ARE SURE. Now tum 
the board over and locate the 
same pins on the bottom of the 
board. VERIFY THIS UNTIL YOU 


ARE SURE. #9, BE EXTREMELY 
CAREFUL AT THIS POINT YOU 
CAN EASILY LIFT A CONDUC- 
TOR FROM THE BOARD. Now 
take your soldering Iron and the 
solder-wick or solder-sucker and 
clean out the holes these pine go 
thru. Now take the needie nose 
pliere and gently loosen the pin 
from each hole. MAKE SURE 
THAT YOU LEAVE NO SOLDER 
SPLASHES OR BRIDGES ON THE 
BOARD. #10, you will now need 
to drill a hole In the case to put the 
ewitoh thru. | would suggest a spot 
between the printer (parallel) port 
and the external disk drive port. 
Cheok that you will have to drill 
thru the bottom shield just the 
plastic and that the switch will 
clear everything. #11, Cut 2 
pieces of wire and bare each end. 
Connect the outelde pine of the 
ewitoh together in the form of aX. | 
Cut 4 lengths of wire 6 Inches long | 
and bare both ends. Bare both 
ends of each piece and solder 
these pieces to the center 
terminale and one set of end 
terminals, it makes no difference 
whioh end. Twist the wires that go 
to each pair of terminals together 
for Identification. #12, Install the 
ewitoh. #13, now back the the 
chip. Using the needie-nose 
pliers, from the top of the board 
gently lift the two pins (19 & 20) 
clear of the board and bring them 
out from the side of the chip. BE 
VERY CAREFUL YOU DON’T 
BREAK A PIN. DON’T BEND 
THEM TO MUCH, JUST ENOUGH 
TO CLEAR THE BOARD AND 





HAVE ROOM TO REACH THE 
HOLES THEY CAME OUT OF. 
#14, out the wires from the switch 
to reach to the pine of the U-18 
chip and strip the ende. Then take 
one pair of wires and insert them 
thru the open holes, that you 
removed the pine from. Take the 
other pair of wires and solder 
them directly on the pine of the 
chip. Turn the board over and 
solder the wires thal you poked 
thru the holes. Neaten up the 
Wires. VERIFY ALL CONNEC- 
TIONS AND THAT NOTHING [8 
TOUCHING ANYTHING IT 
SHOULDN'T BE ALSO THAT 
THERE ARE NO SOLDER 
BRIDGES OR SPLASHES. THIS 
COMPLETES THE MODIFICA- 
TION. #16, Repeat steps #7 thru 
#1 IN REVERSE ORDER to 
reassemble the computer. #16, 
Conneot the external drive to the 
computer and aleo connect the 
power and monitor. if the 
computer falle elther of the next 
tests something is wrong, shut the 
computer down and re-check 
what you did. Tum the computer 
on and verify that the activity light 
on one of the drives comes on 
and that the screen display Is 
normal. Turn the computer off and 
change the drive select switch. 
Turn the computer back on and 
verify the other drive activity light 
comes on and thal the soreen 
dieplay le normal. if these teste are 
OK you have correctly installed 
the switch. 8 





Hisoft °C’ GComplier 
continued from page 8... 


standard header flies are 
included. | wae surprised to find 
thai It hae the ability to “link” In 
assembly object files in real-time. 
it le somewhat limited however. 


EDITOR 


The editor ise quite nice with 
standard features of find and 
replace (with wildcards), keyboard 
commands, macros, and the like. 
Kt eeeme to soroll quite quickly. | 
did notice that | could define a 
block with the mouse, although | 
could position the oureor with It. 


To pagedown, one can't hit 
Ctrl-Down Arrow, which | didn’t 


like. All my word processors have 
that keystroke. instead, it is F10. 


COMPILING 


Taking code from the Hisoft 
interpreter to your compiler . 
lsrelatively simple. First, covert It 
from its tokenized format to an 
ASCIl text flie, convert the header 
files, and compile it directly. 


The only problem that | encoun- 
tered wae using functions that 
were HiSoft C specific functions. 
You see, in order to make GEM 
commande easier to work with, 
they have written functions to 
manipulate windows, make 
resource dialog boxes, eto. The 
documentation sald that the 
source code to these functions 
were included lii some tex flies on 
the disk, and that one could just 


compile them directly Into your 
compiler. | found that only some 
of these routines were Included. | 
called MichTron to find out If the 
source code to these functions 
were available elsewhere, but 
support from MichTron wae 
extremely poor; not only did the 
tech not now anything about the 
program, he didn't even have a 
manual. — 


Taking my source code that I've 
written using Mark Willlams and 
trying it out In interpreted mode 
was next to impossible, since most 
_ of my code uses the commands 
that | listed above ae not being 
implemented. Although, simple 
code I’m sure would work. 


EVALUATION 


Although | have listed many of 
fauite with thie program, | certainty 
recommend it. if you are just 
learning C, there is nothing better 
than this program and a good 
tutorial. if you have been 
developing for many years, | 
would recommend it because of 
the decrease in development time 
spent in compliing. 


It would be nice if they would 
make an ANSI compatible version, 
but the current version i¢ quite 
adequate for most needs. 


R 


BEMEMBER! 


Beginning with the next issue 
(Oct. ’89), STUN will be 
converting to a disk based 
format, and will be distribu- 
ted at the monthly meet- 
Ings. If you aren't able to 
get your newsletter at the 
meeting, you may still obtain 
It two ways: 


1. Newsletter Issues will be 
upload to the H.0.G. after 
each monthly meeting. 


2. Copies will be available 
from the club library for the 
normal $3.00 charge. 


R 


THE NEXT 


MEETING IS: 


let. 18, lg8g 
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